/**
 * This file is part of 1genia trampoline
 * Copyright (C) 2007 1genia (contact@1genia.com)
 *
 * This library is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; version 3 of the License. 
 *
 * This library is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details. 
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; see the file COPYING.TXT.  If not,
 * write to the Free Software Foundation, Inc., 51 Franklin Street,
 * Fifth Floor, Boston, MA 02110-1301, USA. 
 **/
package com.genia.toolbox.projects.toolbox_basics_project.business.dao;

import com.genia.toolbox.persistence.exception.PersistenceException;
import com.genia.toolbox.projects.toolbox_basics_project.bean.model.Region;

/**
 * the region business dao interface.
 */
public interface RegionBusinessDao
{

  /**
   * update {@link Region} region.
   * 
   * @param region
   *          to update
   * @return the {@link Region}.
   * @throws PersistenceException
   *           the persistence exception.
   */
  public Region updateRegion(Region region)
      throws PersistenceException;



  /**
   * save {@link Region} region.
   * 
   * @param region
   *          to save
   * @return the {@link Region}.
   * @throws PersistenceException
   *           the persistence exception.
   */
  public Region saveRegion(Region region)
      throws PersistenceException;



  /**
   * returns a {@link Region} knowing its identifier.
   * 
   * @param identifier
   *          the identifier of the {@link Region}
   * @return the {@link Region} associated to the given identifier or
   *         <code>null</code> if no such region exists.
   */
  public Region getRegion(Long identifier);



  /**
   * delete {@link Region} with this identifier.
   * 
   * @param identifier
   *          {@link Region} identifier.
   * @throws PersistenceException
   *           the persistence exception.
   */
  public void delete(Long identifier)
      throws PersistenceException;

}
